home *** CD-ROM | disk | FTP | other *** search
ppppkkkkggggmmmmaaaapppp((((4444)))) ppppkkkkggggmmmmaaaapppp((((4444)))) NNNNAAAAMMMMEEEE _pppp_kkkk_gggg_mmmm_aaaa_pppp - package contents description file DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _pppp_kkkk_gggg_mmmm_aaaa_pppp is an ASCII file that provides a complete listing of the package contents. It is automatically generated by _pppp_kkkk_gggg_mmmm_kkkk(1) using the information in the _pppp_rrrr_oooo_tttt_oooo_tttt_yyyy_pppp_eeee file. Each entry in _pppp_kkkk_gggg_mmmm_aaaa_pppp describes a single ``deliverable object file.'' A deliverable object file includes shell scripts, executable objects, data files, directories, and so on. The entry consists of several fields of information, each field separated by a space. The fields are described below and must appear in the order shown. _p_a_r_t An optional field designating the part number in which the object resides. A part is a collection of files, and is the atomic unit by which a package is processed. A developer can choose the criteria for grouping files into a part (for example, based on class). If no value is defined in this field, part 1 is assumed. _f_t_y_p_e A one-character field that indicates the file type. Valid values are: _ffff a standard executable or data file _eeee a file to be edited upon installation or removal _vvvv volatile file (one whose contents are expected to change) _dddd directory _xxxx an exclusive directory (See NOTES) _llll linked file _pppp named pipe _cccc character special device _bbbb block special device _iiii installation script or information file _ssss symbolic link _c_l_a_s_s The installation class to which the file belongs. This name must contain only alphanumeric characters and be no longer than 12 characters. It is not specified if the _ffff_tttt_yyyy_pppp_eeee is _iiii (information file). _p_a_t_h_n_a_m_e The pathname where the object will reside on the target machine, such as _////_uuuu_ssss_rrrr_////_bbbb_iiii_nnnn_////_mmmm_aaaa_iiii_llll. Relative pathnames (those that do not begin with a slash) indicate that the file is relocatable. For linked files (_ffff_tttt_yyyy_pppp_eeee is either _llll or _ssss), pathname must be in the form of _p_a_t_h_1_====_p_a_t_h_2, with _p_a_t_h_1 specifying the destination of the link and _p_a_t_h_2 specifying the source of the link. PPPPaaaaggggeeee 1111 ppppkkkkggggmmmmaaaapppp((((4444)))) ppppkkkkggggmmmmaaaapppp((((4444)))) For symbolically linked files, when _p_a_t_h_2 is a relative pathname starting with _p_a_t_h_2 is not considered relocatable. For example, if you enter a line such as _ssss _////_ffff_oooo_oooo_////_bbbb_aaaa_rrrr_////_eeee_tttt_cccc_////_mmmm_oooo_uuuu_nnnn_tttt_====_...._...._////_uuuu_ssss_rrrr_////_ssss_bbbb_iiii_nnnn_////_mmmm_oooo_uuuu_nnnn_tttt _p_a_t_h_1 (_////_ffff_oooo_oooo_////_bbbb_aaaa_rrrr_////_eeee_tttt_cccc_////_mmmm_oooo_uuuu_nnnn_tttt) will be a symbolic link to _...._...._////_uuuu_ssss_rrrr_////_ssss_bbbb_iiii_nnnn_////_mmmm_oooo_uuuu_nnnn_tttt. _p_a_t_h_n_a_m_e may contain variables which support relocation of the file. A _$$$$_p_a_r_a_m_e_t_e_r may be embedded in the pathname structure. _$$$$_BBBB_AAAA_SSSS_EEEE_DDDD_IIII_RRRR can be used to identify the parent directories of the path hierarchy, making the entire package easily relocatable. Default values for _p_a_r_a_m_e_t_e_r and _BBBB_AAAA_SSSS_EEEE_DDDD_IIII_RRRR must be supplied in the _pppp_kkkk_gggg_iiii_nnnn_ffff_oooo file and may be overridden at installation. Special characters, such as an equal sign (_====), are included in pathnames by surrounding the entire pathname in single quotes (as in, for example, _''''_////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_~~~~_====_''''). _m_a_j_o_r The major device number. The field is only specified for block or character special devices. _m_i_n_o_r The minor device number. The field is only specified for block or character special devices. _m_o_d_e The octal mode of the file (for example, 0664). A question mark (?) indicates that the mode will be left unchanged, implying that the file already exists on the target machine. This field is not used for linked files, packaging information files or non-installable files. _o_w_n_e_r The owner of the file (for example, _bbbb_iiii_nnnn or _rrrr_oooo_oooo_tttt). The field is limited to 14 characters in length. A question mark (?) indicates that the owner will be left unchanged, implying that the file already exists on the target machine. This field is not used for linked files or non-installable files. It is used optionally with a package information file. If used, it indicates with what owner an installation script will be executed. Can be a variable specification in the form of _$$$$_[[[[_AAAA_----_ZZZZ_]]]]. Will be resolved at installation time (see NOTES). _g_r_o_u_p The group to which the file belongs (for example, "bin" or "sys"). The field is limited to 14 characters in length. A question mark (?) indicates that the group will be left unchanged, implying that the file already exists on the target machine. This field is not used for linked files or non- installable files. It is used optionally with a package information file. If used, it indicates with what group an installation script will be executed. PPPPaaaaggggeeee 2222 ppppkkkkggggmmmmaaaapppp((((4444)))) ppppkkkkggggmmmmaaaapppp((((4444)))) Can be a variable assignment in the form of _$$$$_[[[[_AAAA_----_ZZZZ_]]]]. Will be resolved at installation time (see NOTES). _s_i_z_e The actual size of the file in bytes. This field is not specified for named pipes, special devices, directories or linked files. _c_k_s_u_m The checksum of the file contents. This field is not specified for named pipes, special devices, directories or linked files. _m_o_d_t_i_m_e The time of last modification, as reported by the _ssss_tttt_aaaa_tttt(2) function call. This field is not specified for named pipes, special devices, directories or linked files. PPPPaaaaggggeeee 3333 ppppkkkkggggmmmmaaaapppp((((4444)))) ppppkkkkggggmmmmaaaapppp((((4444)))) Each _pppp_kkkk_gggg_mmmm_aaaa_pppp must have one line that provides information about the number and maximum size (in 512-byte blocks) of parts that make up the package. This line is in the following format: _::::_n_u_m_b_e_r__o_f__p_a_r_t_s _m_a_x_i_m_u_m__p_a_r_t__s_i_z_e Lines that begin with ``_####'' are comment lines and are ignored. When files are saved during installation before they are overwritten, they are normally just copied to a temporary pathname. However, for files whose mode includes execute permission (but which are not editable), the existing version is linked to a temporary pathname and the original file is removed. This allows processes which are executing during installation to be overwritten. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS The following is an example of a _pppp_kkkk_gggg_mmmm_aaaa_pppp file. _::::_2222 _5555_0000_0000 _1111 _iiii _pppp_kkkk_gggg_iiii_nnnn_ffff_oooo _2222_3333_7777 _1111_1111_7777_9999 _5555_4444_1111_2222_9999_6666_6666_7777_2222 _1111 _bbbb _cccc_llll_aaaa_ssss_ssss_1111 _////_dddd_eeee_vvvv_////_dddd_iiii_ssss_kkkk_eeee_tttt_tttt_eeee _1111_7777 _1111_3333_4444 _0000_6666_4444_4444 _rrrr_oooo_oooo_tttt _oooo_tttt_hhhh_eeee_rrrr _1111 _cccc _cccc_llll_aaaa_ssss_ssss_1111 _////_dddd_eeee_vvvv_////_rrrr_dddd_iiii_ssss_kkkk_eeee_tttt_tttt_eeee _1111_7777 _1111_3333_4444 _0000_6666_4444_4444 _rrrr_oooo_oooo_tttt _oooo_tttt_hhhh_eeee_rrrr _1111 _dddd _nnnn_oooo_nnnn_eeee _bbbb_iiii_nnnn _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _1111 _ffff _nnnn_oooo_nnnn_eeee _bbbb_iiii_nnnn_////_IIII_NNNN_SSSS_TTTT_AAAA_LLLL_LLLL _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _1111_1111_1111_0000_3333 _1111_7777_9999_5555_4444 _5555_4444_1111_2222_9999_5555_5555_3333_5555 _1111 _ffff _nnnn_oooo_nnnn_eeee _bbbb_iiii_nnnn_////_RRRR_EEEE_MMMM_OOOO_VVVV_EEEE _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _3333_2222_1111_4444 _5555_0000_2222_3333_7777 _5555_4444_1111_2222_9999_5555_5555_4444_1111 _1111 _llll _nnnn_oooo_nnnn_eeee _bbbb_iiii_nnnn_////_UUUU_NNNN_IIII_NNNN_SSSS_TTTT_AAAA_LLLL_LLLL_====_bbbb_iiii_nnnn_////_RRRR_EEEE_MMMM_OOOO_VVVV_EEEE _1111 _ffff _nnnn_oooo_nnnn_eeee _bbbb_iiii_nnnn_////_cccc_mmmm_dddd_aaaa _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _3333_5555_8888_0000 _6666_0000_3333_2222_5555 _5555_4444_1111_2222_9999_5555_5555_6666_7777 _2222 _NNNN_UUUU_LLLL_LLLL _1111 _ffff _nnnn_oooo_nnnn_eeee _bbbb_iiii_nnnn_////_cccc_mmmm_dddd_bbbb _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _4444_9999_1111_0000_7777 _5555_1111_2222_5555_5555 _5555_4444_1111_4444_3333_8888_3333_6666_8888 _1111 _ffff _cccc_llll_aaaa_ssss_ssss_1111 _bbbb_iiii_nnnn_////_cccc_mmmm_dddd_cccc _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _4444_5555_5555_9999_9999 _2222_6666_0000_4444_8888 _5555_4444_1111_2222_9999_5555_5555_9999_9999 _1111 _ffff _cccc_llll_aaaa_ssss_ssss_1111 _bbbb_iiii_nnnn_////_cccc_mmmm_dddd_dddd _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _4444_6666_4444_8888 _8888_4444_7777_3333 _5555_4444_1111_4444_6666_1111_2222_3333_8888 _1111 _ffff _nnnn_oooo_nnnn_eeee _bbbb_iiii_nnnn_////_cccc_mmmm_dddd_eeee _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _4444_0000_5555_0000_1111 _1111_2222_6666_4444 _5555_4444_1111_2222_9999_5555_6666_2222_2222 _1111 _ffff _cccc_llll_aaaa_ssss_ssss_2222 _bbbb_iiii_nnnn_////_cccc_mmmm_dddd_ffff _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _2222_3333_4444_5555 _3333_5555_8888_8888_9999 _5555_4444_1111_2222_9999_5555_5555_7777_4444 _1111 _ffff _nnnn_oooo_nnnn_eeee _bbbb_iiii_nnnn_////_cccc_mmmm_dddd_gggg _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _4444_1111_1111_8888_5555 _4444_7777_6666_5555_3333 _5555_4444_1111_4444_6666_1111_2222_4444_2222 _2222 _dddd _cccc_llll_aaaa_ssss_ssss_2222 _dddd_aaaa_tttt_aaaa _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _2222 _pppp _cccc_llll_aaaa_ssss_ssss_1111 _dddd_aaaa_tttt_aaaa_////_aaaa_pppp_iiii_pppp_eeee _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _oooo_tttt_hhhh_eeee_rrrr _2222 _dddd _nnnn_oooo_nnnn_eeee _llll_oooo_gggg _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _1111 _NNNN_UUUU_LLLL_LLLL _NNNN_UUUU_LLLL_LLLL _2222 _vvvv _nnnn_oooo_nnnn_eeee _llll_oooo_gggg_////_llll_oooo_gggg_ffff_iiii_llll_eeee _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _4444_1111_8888_1111_5555 _4444_7777_5555_6666_3333 _5555_4444_1111_4444_6666_1111_3333_3333_3333 _2222 _dddd _nnnn_oooo_nnnn_eeee _ssss_aaaa_vvvv_eeee _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _2222 _dddd _nnnn_oooo_nnnn_eeee _ssss_pppp_oooo_oooo_llll _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn _2222 _dddd _nnnn_oooo_nnnn_eeee _tttt_mmmm_pppp _0000_7777_5555_5555 _rrrr_oooo_oooo_tttt _bbbb_iiii_nnnn NNNNOOOOTTTTEEEESSSS The _pppp_kkkk_gggg_mmmm_aaaa_pppp file may contain only one entry per unique pathname. An exclusive directory type (_f_i_l_e) type _xxxx) specifies directories that are constrained to contain only files that appear in the installation software database (_////_vvvv_aaaa_rrrr_////_ssss_aaaa_dddd_mmmm_////_iiii_nnnn_ssss_tttt_aaaa_llll_llll_////_cccc_oooo_nnnn_tttt_eeee_nnnn_tttt_ssss). If there are other files in the directory, they will be removed by _pppp_kkkk_gggg_cccc_hhhh_kkkk _----_ffff_xxxx as described on the _pppp_kkkk_gggg_cccc_hhhh_kkkk(1M) manual page. PPPPaaaaggggeeee 4444 ppppkkkkggggmmmmaaaapppp((((4444)))) ppppkkkkggggmmmmaaaapppp((((4444)))) Variable specifications for the _o_w_n_e_r and _g_r_o_u_p fields are defined in the _pppp_kkkk_gggg_iiii_nnnn_ffff_oooo file. For example, _o_w_n_e_r could be _$$$$_OOOO_WWWW_NNNN_EEEE_RRRR in the _pppp_kkkk_gggg_mmmm_aaaa_pppp file; if _OOOO_WWWW_NNNN_EEEE_RRRR is defined as _rrrr_oooo_oooo_tttt in the _pppp_kkkk_gggg_iiii_nnnn_ffff_oooo file, _$$$$_OOOO_WWWW_NNNN_EEEE_RRRR will get the value _rrrr_oooo_oooo_tttt when the file is installed. PPPPaaaaggggeeee 5555 
